home *** CD-ROM | disk | FTP | other *** search
/ Palm Utilities / Palm_Utilities_CD-ROM_2001_2001.iso / files / utils hack / Silence 1.5.1 / silence151.exe / readme.txt next >
Encoding:
Text File  |  2000-06-20  |  13.1 KB  |  292 lines
  1.  
  2. This is Readme.txt for Silence version 1.5.1
  3.  
  4. Silence is ⌐1999 by Roger Chaplin <foursquaredev@att.net>
  5.                         http://home.att.net/~foursquaredev/
  6.  
  7.  
  8. ----------------
  9. | Introduction |
  10. ----------------
  11.  
  12. Silence causes your Palm Computing(R) platform device to be completely
  13. silent during time periods that you specify. Regardless of the sound
  14. settings in your system preferences, your device will make absolutely no
  15. sound at all. Program in the times that you have regularly scheduled
  16. meetings, church services, etc. Silence also provides an immediate action
  17. toggle control, so you can make your device silent independently of programmed
  18. times.
  19.  
  20. Features:
  21. o   Unlimited number of programmed silent periods
  22. o   Silent periods can be either one-time, or repeating
  23. o   Uses the same user interface scheme as the built in Palm (tm) Date Book,
  24.     so no re-learning is required
  25. o   Quickly silence or un-silence your device with a programmable pen stroke,
  26.     without leaving the app you are presently using
  27. o   Pen stroke silence can last indefinitely, or for a programmable time
  28.     duration
  29. o   Optional silence indicator icon visible at all times
  30.  
  31. Silence requires either Hackmaster (shareware, available at
  32. http://www.daggerware.com), or EVPlugBase (freeware, available at
  33. http://www.evscl.com/en/en_evplug.html). If you decide to use HackMaster,
  34. please register it.
  35.  
  36.  
  37. ----------------
  38. | Installation |
  39. ----------------
  40.  
  41. The Silence distribution includes this readme file, plus two PRC files:
  42. SilenceHack.prc and Silence.prc. Use the following procedure to install
  43. Silence:
  44.  
  45. 1.  If you have not yet installed HackMaster or EVPlugBase, do so
  46. 2.  IMPORTANT: if you are upgrading from any previous version of Silence,
  47.     launch HackMaster or EVPlugBase (whichever you use) and disable
  48.     SilenceHack. FAILURE TO PERFORM THIS STEP WILL CAUSE YOUR DEVICE TO CRASH,
  49.     POSSIBLY RESULTING IN LOSS OF DATA.
  50. 3.  IMPORTANT: if you are upgrading from Silence v1.2 or earlier, and you have
  51.     used FlashPro to move Silence and/or SilenceHack into flash memory, you
  52.     must first disable all hacks, then use FlashPro to move Silence and
  53.     SilenceHack back into normal RAM. FAILURE TO PERFORM THIS STEP WILL
  54.     CAUSE YOUR DEVICE TO CRASH, POSSIBLY RESULTING IN LOSS OF DATA.
  55. 4.  IMPORTANT: if you are upgrading from Silence v1.3 or earlier, use the app
  56.     launcher to delete Silence from your device (you do not have to delete
  57.     SilenceHack, although you may if you wish). FAILURE TO PERFORM THIS STEP
  58.     WILL CAUSE YOUR DEVICE TO CRASH, POSSIBLY RESULTING IN LOSS OF DATA.
  59. 5.  Install both the PRC files onto your Palm Computing device
  60. 6.  Launch HackMaster or EVPlugBase and enable SilenceHack
  61.  
  62.  
  63. ---------------
  64. | Usage Notes |
  65. ---------------
  66.  
  67. Your device will be silent if the "Immediate silence" checkbox is checked or
  68. if any of your programmed silent periods are active. The silence state is
  69. indicated by a small icon near the lower left corner of the Silence list view.
  70.  
  71. When a silent period is active, a small black diamond appears beside it at the
  72. right edge of the display. Repeating periods are indicated by a single letter
  73. at the left edge of the display:
  74.     D   daily repeat
  75.     W   weekly repeat
  76.     M   monthly repeat
  77.     Y   yearly repeat
  78. A blank space indicates a non-repeating period.
  79.  
  80. During a silent period, apps can still generate alarms. Any visual alarm
  81. indicators (such as the app's alarm dialog, flashing backlight, TaleLight,
  82. TaleVibes, etc.) still work. Only the audio is affected.
  83.  
  84. When you are editing a silent period, changes you make to the start date/time
  85. have no effect on the period's duration; that is, the end date/time changes
  86. along with the start date/time. Changes you make to the end date/time do
  87. affect the duration of the period; that is, the start date/time does not
  88. change.
  89.  
  90. Non-repeating silent periods are automatically deleted once they have expired.
  91.  
  92. If you want to cancel an active silent period (e.g. the meeting during which
  93. you wanted the silence ended early), tap on the black diamond. It will change
  94. to a hollow diamond, and the period will no longer contribute to the silent
  95. state of your device.  At the end of the period, it will become idle and
  96. either be deleted (if it is a non-repeating period) or adjusted for the next
  97. ocurrence (if it is a repeating period).
  98.  
  99. If you have selected "forever" for the "Immediate silence" duration, enabling
  100. the checkbox will cause your device to remain silent forever, or until you
  101. disable the checkbox. If you have selected a definite time duration, enabling
  102. the checkbox will cause your device to remain silent for that length of time.
  103. Disabling and then re-enabling the checkbox re-starts the time. The time
  104. duration controls cannot be changed while the checkbox is enabled.
  105.  
  106. You can also toggle the "Immediate silence" control on and off without
  107. launching Silence, by making a pen stroke between two of the silkscreened
  108. buttons that are on either side of the Graffiti area (Applications, Menu,
  109. Calculator, and Find). You can select which button marks the start of the
  110. stroke, and which button marks the end. To make the pen stroke, put the pen
  111. down on the "beginning" button, slide the pen to the "end" button, then lift
  112. the pen. The controls for this feature are accessible from the Silence menu,
  113. on Options.  When you have enabled the feature, every time you stroke from the
  114. start button to the end button, the "Be silent for" control will toggle.
  115. (Remember that if one of your programmed silent periods is active, the
  116. immediate control has no effect upon the device's silent status.)
  117.  
  118. The pen stroke feature is inactive while you are in the HotSync application,
  119. to prevent you from inadvertently toggling silence while a HotSync operation
  120. is underway. Toggling silence while a HotSync operation is underway can crash
  121. your device.
  122.  
  123. You can choose to make an icon visible at all times that indicates the silence
  124. status of your device. The controls for this feature are accessible from the
  125. Silence menu, on Options. You can choose any of the four corners of the screen
  126. for this icon to appear.
  127.  
  128. When Silence enters or exits one of your programmed silent periods, or when
  129. you use the pen stroke to toggle the immediate silence, it indicates this
  130. change in one of two ways, depending upon whether the icon indicator feature
  131. is enabled:
  132.     o If the icon indicator feature is enabled, the icon simply changes to
  133.       reflect the new silence state.
  134.     o If the icon indicator feature is not enabled, Silence pops up a message
  135.       box for two seconds. However, the message box appears only if your
  136.       device is turned on when the transition occurs. If your device is off at
  137.       the time, Silence still makes the transition into or out of the silent
  138.       period, but does not display the message box.
  139.  
  140. -----------------
  141. | Compatibility |
  142. -----------------
  143.  
  144. There are no known conflicts between Silence and any other app or hack.
  145. Silence runs on any Palm Computing platform device using Palm OS 2.0 or
  146. greater. This includes PalmPilot Personal and Professional, and all Palm III,
  147. V, and VII series, as well as Handspring Visor and TRGPro. Silence will not
  148. run on the Pilot 1000 and 5000.
  149.  
  150. Some apps bypass the Palm OS to play sounds (one example is Galax). Silence
  151. cannot make these apps silent.
  152.  
  153.  
  154. -----------
  155. | License |
  156. -----------
  157.  
  158. Silence is shareware. You are free to try it out, but if you continue using it
  159. for more than 30 days you are obliged to register and pay. Once you have paid,
  160. you will receive an unlock key that you can use to eliminate the nag screen
  161. that appears each time you launch Silence. Even before you register and unlock
  162. Silence, it is fully functional. Use the 30-day trial period to your
  163. advantage, and be sure to give Silence a complete evaluation. All sales are
  164. final.
  165.  
  166. You are entitled to use a registered copy of Silence on a single handheld. If
  167. you wish to install and use it on more than one device, you must register a
  168. copy for each device.
  169.  
  170. Registered users get first priority for support, and receive upgrades at no
  171. extra cost.
  172.  
  173.  
  174. ---------------
  175. | Registering |
  176. ---------------
  177.  
  178. Registration of Silence costs $5.00. You can register at either PalmGear H.Q.
  179. or Handango.
  180.  
  181. PalmPilotGear H.Q.:
  182.     2500 East Randol Mill Road, Suite 117
  183.     Arlington, TX 76017
  184.     800.741.9070
  185.     http://www.palmgear.com/
  186.  
  187. Handango:
  188.     http://www.handango.com/
  189.  
  190. The registration screen that appears when you first launch Silence shows your
  191. RegCode. Using this RegCode value when you register at PalmPilotGear H.Q. or
  192. Handango will help to ensure that you receive the correct unlock key.
  193.  
  194. If you wish to register more than one copy, enter the Pilot User Name and/or
  195. RegCode for one of the devices on the online order form, and email the other
  196. Pilot User Name and/or RegCodes directly to foursquaredev@att.net.
  197.  
  198.  
  199. ------------------
  200. | Known Problems |
  201. ------------------
  202.  
  203. None.
  204.  
  205.  
  206. --------------------
  207. | Revision History |
  208. --------------------
  209.  
  210. June 19, 2000       v1.5.1
  211.     o   Fixed the "missing hours list" bug on the set time screen (this bug
  212.         did not manifest itself on Palm OS 3.5, only on earlier OS versions)
  213.     o   Updated documentation to state that Silence requires Palm OS 2.0 or
  214.         greater
  215.  
  216. June 18, 2000       v1.5
  217.     o   Added the indicator icon feature
  218.     o   Bug fix: changing the start date of a repeat weekly silent period now
  219.         updates the Repeat on day control buttons to match the new start day
  220.     o   Bug fix: repeating periods that are repeat monthly by
  221.         day-of-the-month, and having an Every setting other than 1, now work
  222.         correctly (previously these repeated every month, regardless of the
  223.         Every setting)
  224.     o   Bug fix: Immediate silence durations of 10-19 hours, inclusive, did
  225.         not work -- the checkbox would immediately uncheck itself
  226.     o   Rearranged the main view controls, and re-labeled the "Be silent for"
  227.         checkbox to "Immediate silence", to provide more consistency
  228.  
  229. March 4, 2000       v1.4.1
  230.     o   Now properly imports preferences and registration code from v1.3
  231.  
  232. March 3, 2000       v1.4
  233.     o   Fixed the fatal error on Palm OS 3.3 when enabling "Toggle immediate
  234.         silence on and off with a pen stroke" on the Options screen.
  235.     o   Fixes to eliminate errors on Palm OS 3.5.
  236.  
  237. August 16, 1999     v1.3
  238.     o   The "Be silent immediately" control is now "Be silent for" and has
  239.         a programmable time duration (this is the one feature most requested).
  240.     o   Changed list view silence indication from text to graphic icon in the
  241.         lower left corner of the display.
  242.     o   Added "New" button, removed "New" from the menu.
  243.     o   The pen stroke popup indicator now appears always in the center of the
  244.         display.
  245.     o   Added popup indicator whenever entering into or exiting from a
  246.         programmed silent period (not just when performing the silence toggle
  247.         pen stroke).
  248.     o   Rewrote the SilenceHack part to eliminate a potential fatal error
  249.         under critically low battery conditions.
  250.  
  251. July 18, 1999       v1.2
  252.     o   New feature: When the time arrives for Silence to enter into or exit
  253.         from a programmed silent period, if the device is off, it must awaken
  254.         in order to make the transition. It used to then remain on until the
  255.         auto off time expired. Now, it turns itself back off immediately.
  256.         Thanks to Ron Gouldner (http://www.rgps.com/) for the tip on how to
  257.         make this work.
  258.     o   The pen stroke popup indicator now appears in the upper left corner of
  259.         the active window. This works better for those situations where you
  260.         have a modal dialog open or a popup list open.
  261.  
  262. July 6, 1999        v1.11
  263.     o   Disable pen stroke while the HotSync application is running
  264.     o   Bugfix: Pen stroke in unregistered version popped up the registration
  265.         form, which sometimes caused a fatal error. Now a simple reminder pops
  266.         up instead of the registration form.
  267.  
  268. July 3, 1999        v1.1
  269.     o   New feature: pen stroke to toggle immediate silence on/off
  270.     o   Bugfix: Resetting the device after installing Silence but before
  271.         launching it would hang the device
  272.     o   Bugfix: Resetting the device would cause Silence to never transition
  273.         into the next silent period (if it was not in a silent period), or
  274.         to exit from the active silent period(s) (if it was in a silent
  275.         period)
  276.  
  277. June 16, 1999       v1.0
  278.     o   First public release
  279.     o   Bugfix: edit view end date did not get updated correctly when a change
  280.         in start date caused the period to span midnight
  281.  
  282. June 6, 1999        v0.2b (Beta)
  283.     o   Bugfix: editing a period while it was suspended (hollow diamond)
  284.         caused it to become active (black diamond)
  285.     o   Bugfix: dates displayed on the list view now obey the system
  286.         preferences setting for how dates ought to be displayed
  287.     o   New feature: the list view now indicates the repeat type of each
  288.         period by a single letter at the left edge of the display
  289.  
  290. May 31, 1999        v0.1b (Beta)
  291.     o   First beta release. No changes from v0.7a.
  292.